home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / program / facd12.zip / FACADE.TXT < prev    next >
Text File  |  1995-01-13  |  21KB  |  470 lines
  1.  
  2.  
  3.  
  4.     ╔════════════════════════════════════════════════════════════════════╗
  5.     ║                                                                    ║
  6.     ║                                                                    ║
  7.     ║                             Facade(tm)                             ║
  8.     ║                        -------------------                         ║
  9.     ║                                                                    ║
  10.     ║      developers' pcx splashscreen display for DOS applications     ║
  11.     ║                                                                    ║
  12.     ║                                                                    ║
  13.     ║                                                                    ║
  14.     ║                                                                    ║
  15.     ║                     a product of RCCO Research                     ║
  16.     ║                                                                    ║
  17.     ║                                                                    ║
  18.     ╚════════════════════════════════════════════════════════════════════╝
  19.  
  20.  
  21.  
  22. Capabilities
  23. -------------
  24. Facade(tm) is basically a simple loader program that allows DOS executable
  25. applications to display a developer-designed VGA .pcx file as a sign-on
  26. image.  Upon normal execution of the main application, Facade releases
  27. itself from memory, thus adding no overhead to the executable sequence.
  28.  
  29. The splashscreen displays for four (4) seconds, then calls the main
  30. executable just as it would have been executed from the system prompt.
  31.  
  32. Facade may be used with most traditional MS-DOS language executables,
  33. including those created with CA-Clipper, Borland Turbo Pascal, QuickBASIC,
  34. PowerBasic, Visual Basic(tm) for DOS, FoxPro, dBase, Clarion, C, etc.
  35.  
  36. Facade image displays will run under both DOS and Windows (full DOS screen).
  37. The utility is particularly effective for software developers preparing
  38. copyright or other splashscreens of their products.  The chief advantages,
  39. aside from the presentations themselves, are both low cost and method of
  40. acquiring.  The copy included herewith is a fully-functional evaluation
  41. copy available easily and universally through the user-supported software
  42. marketplace.
  43.  
  44. Please note there is a similarly-named version of Facade called Facade-C
  45. (Facade for Clipper), also from RCCO Research, which is specifically designed
  46. for developers using CA-Clipper(R).  The present version of Facade will also
  47. work well with Clipper, but we must point out the similar names to help avoid
  48. confusion about the two products.
  49.  
  50.  
  51.  
  52.  
  53. Facade.exe and the sample files
  54. --------------------------------
  55. To run the files included in this package (FACADE.EXE and 2 sample files:
  56. _ADMIN.PCX, _OVERL.EXE) simply execute
  57.  
  58.                            FACADE <enter>
  59.  
  60. from the DOS prompt.
  61.  
  62.  
  63.  
  64.  
  65. Preparation of images
  66. ----------------------
  67. Facade is particularly effective for software developers preparing copyright
  68. or other splashscreens of their products, in that they can easily capture
  69. usable materials with programs like Hijaak(tm) for Windows and modify or
  70. create them in editing programs such as Windows(tm) Paintbrush.
  71.  
  72. The only requirement is that images must be finally saved in 640x480 16-
  73. color VGA .pcx file format.  If you are doing image preparation in Windows,
  74. you will have to load a 16-color video driver for 640x480 VGA in order to
  75. prepare proper images.  This format is used since it is the most universal
  76. that will allow presentations to be viewed on as many DOS and/or Windows
  77. VGA systems as possible.  Do not build your images with 256 or more colors
  78. as they will not display with Facade.  The end-user should then be able
  79. to properly display using any VGA card and driver with 16 or more colors;
  80. it is only during the preparation and saving of .pcx images that you must
  81. use a 640x480x16 driver.
  82.  
  83. We have observed excellent, consistent results with using a program such as
  84. Hijaak(tm) for Windows to capture entire DOS or Windows screens, or selected
  85. areas of screens, or a particular window on a full Windows screen.  The
  86. preparer then does final editing, adding text, drawing lines or other objects,
  87. in a drawing program.  For example, the sample sign-on screen provided with
  88. this package was done entirely in the program that comes free with Windows:
  89. Paintbrush.  The inset picture was captured from a black and white line
  90. drawing with a hand scanner and edited in Paintbrush.
  91.  
  92. Other graphics programs are likely to provide compatible material, but they
  93. must be tried on a test basis with Facade.  The two programs mentioned
  94. above work well for most users, are widely available, and do not require
  95. great technical or professional ability.  Scanned images will be effective
  96. in Facade if they are saved in the proper format.  If one format you are
  97. using seems not workable, try saving that image in another program, such as
  98. Windows Paintbrush; we have often found that certain images work better when
  99. converted or simply saved in another program's format even though they may
  100. use the same .pcx extension.
  101.  
  102. When attempting to use monochrome pcx files, resave them as 16-color
  103. 640x480 VGA pcx files.  Even though the appearance may remain the same,
  104. they will be saved in a format usable by Facade.
  105.  
  106. Once you find the right combination of steps to produce pcx file formats
  107. consistently usable by Facade, you will save a great deal of time and effort
  108. by always using that combination in future applications.
  109.  
  110.  
  111.  
  112.  
  113.  
  114. Required naming convention for the .pcx file
  115. ---------------------------------------------
  116. After you have prepared the desired .pcx file, simply rename it
  117.  
  118.                                  _ADMIN.PCX
  119.  
  120. The basic requirement is that the image file and the related executables be
  121. placed in the same directory on a hard drive.  Alternatively, the executables
  122. may be in the path, but the file _admin.pcx must be local in every directory
  123. from which you wish the image to display.  You should advise end-users against
  124. running your application from a floppy diskette, due to the slowness of
  125. building the on-screen image when reading from a diskette.
  126.  
  127. Your end-users will certainly need VGA graphics capabilities to view your
  128. splashscreen.  If a user attempts execution on a non-VGA-capable system, a
  129. simple screen will very briefly display the message
  130.  
  131.  
  132.  
  133.  
  134.                    ╔════════════════════════════════════════╗
  135.                    ║                                        ║
  136.                    ║          Loading application...        ║
  137.                    ║                                        ║
  138.                    ╚════════════════════════════════════════╝
  139.  
  140.  
  141.  
  142.               This software program contains copyrighted material.
  143.               All Rights Reserved under International Conventions.
  144.  
  145.  
  146.  
  147.  
  148.  
  149. and continue without much delay.  (The wording on this screen may be changed
  150. by the developer with a hex editor, if desired.)
  151.  
  152.  
  153.  
  154.  
  155.  
  156. Renaming the related executables
  157. ---------------------------------
  158. The developer's executable application to be launched should be renamed
  159.  
  160.                         _OVERL.EXE  (or _OVERL.COM, if a .com file)
  161.  
  162.  
  163. The file FACADE.EXE would be then renamed to 'MYAPP.EXE' or whatever the
  164. developer's application was originally called, so that the end-user executes
  165. the original program name.
  166.  
  167. The calling sequence then becomes:
  168.  
  169.                         MYAPP.EXE <enter>
  170.  
  171.        displays         _ADMIN.PCX  (if VGA system is found)
  172.  
  173.        then executes    _OVERL  (.exe or .com)
  174.  
  175.  
  176. at which point the developer's original application (now called _OVERL.EXE
  177. or _OVERL.COM) will take over and execute normally.  Please recall that very
  178. early versions of DOS will not support renaming of executable files; in 1994
  179. and beyond, we trust this will no longer present a problem.
  180.  
  181. Clipper developers please take note of the Clipper-specific comments about
  182. renaming the main application, under the section Troubleshooting, below.
  183.  
  184. You need not issue a clearscreen command at the beginning of your applica-
  185. tion.  Facade clears the screen automatically upon exiting.
  186.  
  187.  
  188.  
  189.  
  190.  
  191. Troubleshooting
  192. ----------------
  193. One caveat we might offer with this program is that if you find that your
  194. images do not display, or do not display properly, it is probably because
  195. they have been created or saved in a format that may only be slightly
  196. incompatible with that which Facade requires.  Before you decide that the
  197. Facade program is not usable in such instances, try the suggestion given
  198. before for re-saving your .pcx files in another graphics program.  Most
  199. image-editing programs will read files in several formats, and often allow
  200. conversions, or perhaps will save them in a later .pcx format that will work
  201. with applications such as Facade.
  202.  
  203. Also, make certain that images are saved in 640x480 by 16-color format by
  204. using the proper software and/or video drivers to handle the format.
  205.  
  206. Any developer who uses the .RTLink linker and experiences loading errors
  207. with an application and Facade should be cognizant of the information
  208. provided below for Clipper users and be prepared to make similar adjustments,
  209. if needed.  Please let us know if you have continued or other difficulties
  210. in making Facade work as described, as well as any solutions or workarounds
  211. you may have found.
  212.  
  213.  
  214. Clipper-only:
  215. --------------
  216. CA-Clipper(R) 5.x developers using .RTLink or BLINKER who experience runtime
  217. unrecoverable error messages 415 (cannot open overlay file) or 416 (read
  218. error on overlay file) when renaming their executable files to _OVERL.EXE
  219. with the DOS REN command should simply relink the executable as follows:
  220. specify in the .lnk file that the output name is to be _OVERL.EXE (i.e.,
  221. OUTPUT _OVERL).
  222.  
  223. Developers using BLINKER's SwpRunCmd() function should well-test any
  224. application that is loaded with Facade.  If you experience a swap error when
  225. attempting to return from a SwpRunCmd() call, you should consider whether or
  226. not that Blinker function is absolutely essential to the application.  We
  227. know of no workaround at this time other than using the Clipper RUN command.
  228.  
  229. Clipper 5.x developers may also wish to evaluate the companion program,
  230. FACADE-C (Facade for Clipper), a special version of Facade that addresses
  231. Clipper-only issues, including elimination of any momentary screen delay from
  232. the time that Facade calls _OVERL.EXE to the time that it takes for a large
  233. Clipper application to load (Facade-C, with provided Clipper coding, will
  234. allow the Clipper application to load during the time the pcx image is
  235. displayed on the screen).  Facade-C also provides for a default command-line
  236. setting of //E:0 //F:31.  The length of time the image is displayed to the
  237. end-user may be specified by the developer (standard Facade is set at an
  238. invariable 4 seconds).  While adding some coding (usually about six lines)
  239. on the part of the Clipper developer, Facade-C differs from the standard
  240. version of Facade in that it is slightly less convenient to set up and use.
  241.  
  242. Facade-C is significantly different in internal operation from standard
  243. Facade and may offer an advantage for the serious Clipper developer.  The
  244. executable file sizes for Facade and Facade-C are very similar, however --
  245. a factor that should appeal in particular to the Clipper developer.  A
  246. fully-functional evaluation copy of Facade-C may be obtained from traditional
  247. user-supported software sources, including the Clipper forum library on
  248. CIS and from PsL, Public (software) Library (800-242-4775 or 713-524-6394).
  249.  
  250.  
  251.  
  252.  
  253. Program Requirements
  254. ---------------------
  255. The requirements for running Facade include a DOS-compatible PC with 512k
  256. memory, VGA graphics capability, and a hard drive.  DOS 3.1 (or later) or
  257. Windows 3.x (or later) should be utilized.
  258.  
  259.  
  260.  
  261.  
  262. The Unregistered Evaluation Copy
  263. ---------------------------------
  264. The unregistered version of this program is intended for use in evaluation
  265. situations.  It may be used for ninety (90) days within your own organ-
  266. ization by persons that have knowledge and understanding of the fact that
  267. this is an unregistered evaluation copy.
  268.  
  269. The payment of the $24.95 purchase price for a registered copy of this
  270. program will allow license for a single user to make use of the program for
  271. purposes that are traditionally accepted for software utilities of this
  272. type.  Additional site license fees of $10.00 per user may be paid at the
  273. time of registration, or any time in the future after initial registration
  274. at the then current license fee in effect.  There are no runtime royalties
  275. involved in the distribution of your materials utilizing a duly registered
  276. copy of Facade.
  277.  
  278. The license and authorized registration shall not be construed as being
  279. in effect until direct payment has been received by RCCO Research and an
  280. authorized, registered copy has been sent in the registered user's/users'
  281. name(s).
  282.  
  283.  
  284.  
  285.  
  286.  
  287. The Registered Version of Facade
  288. ---------------------------------
  289. The registered copy performs the same execution as the evaluation copy, only
  290. without the unregistered copy delay at the beginning of the VGA display.
  291.  
  292. Documentation for the registered version is an on-disk text file, similar to
  293. the present format.
  294.  
  295.  
  296.  
  297.  
  298.  
  299. Licensing Information
  300. ----------------------
  301. This program is licensed and supplied as is, without any warranty.  To the 
  302. extent permitted under applicable law, RCCO Research Associates disclaims 
  303. all warranties, either expressed or implied, with respect to this software 
  304. program, its quality, performance, merchantability, or fitness for any 
  305. particular purpose.
  306.  
  307. In particular, this software program is not guaranteed to prevent or detect
  308. damage to your data or programs.  In no event shall RCCO Research Associates
  309. be liable for any claims for lost profits or any damage, including, but not
  310. limited to, special, incidental, consequential or other damage (including, 
  311. without limitation, damages for loss of business profits, business interrup-
  312. tion, loss of business information, or other pecuniary loss) arising out of
  313. the use of or inability to use this RCCO Research Associates product, even
  314. if RCCO Research Associates has been advised of the possibility of such
  315. damages.  Some states do not allow the exclusion or limitation of incidental
  316. or consequential damages, so the above limitation or exclusion may not apply
  317. to you.  In no case shall RCCO Research Associates's liability exceed the
  318. license fees paid for the right to use the licensed version of the software. 
  319.  
  320. The license agreement and warranty shall be construed, interpreted and
  321. governed by the laws of the state of Tennessee.
  322.  
  323. This software program is protected under the Copyright Laws of the United 
  324. States of America and all applicable International Copyright Conventions.  
  325. Makers and/or users of illegal or unauthorized copies of the registered 
  326. version are subject to prosecution under these laws.
  327.  
  328. The name Facade(tm) is a trademark of RCCO Research Associates.  Windows(tm)
  329. is a trademark of Microsoft Corporation.  Other trade names referenced herein
  330. are either trademarks or registered trademarks of their respective companies.
  331.  
  332.  
  333.  
  334.  
  335.  
  336. Registration Notes
  337. -------------------
  338. Registration will obtain a copy of the most recent authorized version and
  339. provide legal authorization for continued use of the program after the
  340. ninety-day (90-day) evaluation period.
  341.  
  342. To obtain a registered copy, you must mail an advance-payment registration
  343. fee of U.S. $24.95 + $2.55 shipping/handling ($7.05 non-U.S. shipping/
  344. handling, $4.05 for Canada) directly to RCCO Research.  Additional users
  345. are $10.00 per user.  Payment is to be made by check or money order only,
  346. please.  We require payment with order so that prices and fees may be kept
  347. as reasonable as possible; this policy has worked well for us in recent
  348. years, as we observe increased registration on products that are reasonably
  349. priced.  For credit card and telephone orders, see the Additional Ordering
  350. Options note below.
  351.  
  352. An invoice will be included with your order, showing the registered serial
  353. number(s) applicable to the purchase.  We can provide a pro forma invoice
  354. to those corporations or institutions that require same before payment can
  355. be issued; shipment will be made promptly upon receipt of payment.  Prices
  356. and/or registration and/or license fees are subject to change.
  357.  
  358. Tennessee clients please include the required 8.5% sales tax on both the
  359. product amount and shipping/handling as mandated by the state.
  360.  
  361. International clients must pay by check or money order in U.S. dollars, drawn
  362. on a U.S. bank or the U.S. branch of an international bank.  Please realize
  363. that international postal money orders are considerably delayed through the
  364. postal systems and may not be the most expedient way of relaying payment.  An
  365. often-used form of payment consists of obtaining a dollar-denominated money
  366. order from the local American Express office which you may then airmail to
  367. us along with your order.  International orders are dispatched promptly when
  368. using a credit card order as outlined below, under Additional Ordering
  369. Options.
  370.  
  371. Please indicate program name and current version number on your order; you
  372. may use the Order.frm file provided on the disk (or the program directory)
  373. or simply send a note or letter with your name, organization name, address,
  374. program name & version, number of users being licensed, and remittance.
  375. Your comments on our programs are welcomed.
  376.  
  377.  
  378.  
  379.  
  380.      Additional Ordering Options:
  381.      ----------------------------------------------------------------------
  382.      CREDIT CARD ORDERS ONLY -
  383.      You may order a registered copy of this RCCO Research program
  384.      with MC, Visa, Amex, or Discover from PsL, Public (software)
  385.      Library of Houston, Texas by calling 800-242-4775 or 713-524-6394,
  386.      or by FAX to 713-524-6398, or by CompuServe E-mail to 71355,470.
  387.      You may also mail credit card orders to PsL at P.O. Box 35705,
  388.      Houston, TX 77235-5705.  PsL's item/product number for Facade is
  389.      #11622.
  390.  
  391.      THE ABOVE NUMBERS ARE FOR ORDERS ONLY.
  392.      Any questions about the status of the shipment of the order,
  393.      registration options, product details, technical support, volume
  394.      discounts, dealer pricing, site licenses, etc. must be directed in
  395.      writing to RCCO Research, P.O. Box 196, Gatlinburg, TN 37738.  To
  396.      ensure that you get the fastest possible delivery of your registered
  397.      copy, PsL will notify us the day of your order and we will ship the
  398.      materials directly to you.  There are no additional fees for ordering
  399.      by credit card.
  400.  
  401.      Your credit card number is *not* transmitted to RCCO Research, but
  402.      rather is processed by PsL as part of their software registration
  403.      ordering service.
  404.  
  405.      The above service is made available as a convenience to client
  406.      individuals who feel comfortable with ordering by telephone and
  407.      with a credit card.  Established concerns may prefer to order
  408.      directly from RCCO Research with the company's own business check.
  409.  
  410.      The PsL staff cannot answer non-order inquiries.
  411.      ----------------------------------------------------------------------
  412.  
  413.  
  414.  
  415.  
  416.  
  417. Additional Information
  418. -----------------------
  419.  
  420. Facade is written in C using Microsoft C 6.0.
  421.  
  422.  
  423. If you have any comments or questions regarding this program after (or with)
  424. registration, please send them to:
  425.  
  426.                               RCCO Research Associates
  427.                               P. O. Box 196
  428.                               Gatlinburg, TN 37738 (U.S.A.)
  429.  
  430. Please include your phone (day & evening) and fax (if any) numbers as well
  431. as your mailing address (and CompuServe number / Internet address, if any) on
  432. ALL written communications.  Please indicate the serial number from your copy
  433. of the program as well as your CustID number.  Our E-mail addresses are
  434. provided to registered users along with the invoice.
  435.  
  436.  
  437. RCCO Research is the publisher of Visible::Setup(tm) (a developers'
  438. installation utility for DOS applications used widely in many parts of the
  439. world), as well as several other popular development tools.  Please consult
  440. your favorite user-supported software source for the availability of these
  441. and other RCCO Research DOS and Windows programs.
  442.  
  443.  
  444.  
  445.  
  446. Facade(tm)
  447. -----------
  448. developers' pcx splashscreen display for DOS applications
  449.  
  450.  
  451.  
  452. (C) Copyright 1994-95 RCCO Research Associates
  453. All Rights Reserved under International Conventions
  454. Product of U.S.A.
  455.  
  456.  
  457.  
  458. RCCO Research Associates
  459. Post Office Box 196
  460. Gatlinburg, Tennessee 37738 (U.S.A.)
  461.  
  462.  
  463.                                     
  464.                      ┌─────────────────────────────────┐
  465.                      │     RCCO Research Associates    │
  466.                      │ Technical Publishers, Est. 1965 │
  467.                      └─────────────────────────────────┘
  468.  
  469.  
  470.